home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 4 / The Arsenal Files 4 (Arsenal Computer).ISO / ra_qbbs / gcu102.exe / GCU.DOC < prev    next >
Text File  |  1995-01-17  |  18KB  |  384 lines
  1. ┌────────────────────────────────────────────────────────────────────────────┐
  2. │ ▒▒▒ GCU v1.02 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  3. └────────────────────────────────────────────────────────────────────────────┘
  4.  
  5.  
  6.                        GEcho Converion Utilities v1.02
  7.  
  8.                     Copyright (C) 1993 - 1995 Tievelco Group
  9.                             All rights reserved
  10.  
  11.                       Developed with Borland Pascal 7.0
  12.  
  13.                     All information in this documentation
  14.                   is subject to change without prior notice
  15.              
  16.                           Made in the Netherlands
  17.  
  18.  
  19. ┌────────────────────────────────────────────────────────────────────────────┐
  20. │ ▒▒▒ What is GCU ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  21. └────────────────────────────────────────────────────────────────────────────┘
  22.  
  23.  
  24.   GEcho Conversion Utilities is a set of different utilities for FrontDoor 
  25.   or InterMail and using GEcho as echomail tosser. The general reason for 
  26.   writing these utilities was that i needed them. There are already a lot 
  27.   of conversion utilities available but the latest releases are/were not 
  28.   really very uptodate at this moment. 
  29.  
  30.    In GCU you now find the following utilities:
  31.  
  32.    ■ GE2IM,    convert GEcho to InterMail v2.27 - v2.30
  33.  
  34.    ■ GE2FD,    convert GEcho to FrontDoor v2.02NC - v2.20
  35.  
  36.    ■ GE2RA,    convert GEcho to Remote Access v1.11 - 2.0x
  37.  
  38.    ■ GE-NOT,   Write notify messages to 1 node.
  39.  
  40.    I'll try to extend GCU with some other Mailers in some future versions
  41.    I also would like to put some things in GCU which aren't covered yet by 
  42.    GEcho, though they are on Gerard his wishlist, if some functionality in 
  43.    GCU is obsoluted by GEcho i will stop developing that part for those 
  44.    versions.
  45.  
  46.    Why i don't put them in one package?, because i want to make a set off
  47.    utilities that you can put together for your own needs, most programmers 
  48.    do not consider older versions of some software this way you can put them
  49.    together for YOUR system configuration, maybe i might consider to put all
  50.    versions for InterMail in one package and the program itself will try to
  51.    find which version it should use.
  52.  
  53.    I will try to release as soon as possible a new release off the GCU 
  54.    package when there is a new version for some off the programs ( at least
  55.    if their structures change ), if you think it takes to long you can 
  56.    inform me about it since i can't keep track of all new programs/versions.
  57.    
  58. ┌────────────────────────────────────────────────────────────────────────────┐
  59. │ ▒▒▒ The Utils, Small doc's: GE2IM ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  60. └────────────────────────────────────────────────────────────────────────────┘
  61.  
  62.   Below you will find a very small description on how to use the programs.
  63.  
  64.   ■ GE2IM convert GEcho to InterMail 
  65.     GE2IM doesn't need any configuration, it will look for both GEcho and
  66.     the InterMail environment for the nessesary configuration files.
  67.     When GE2IM is executed it will read SETUP.GE from GEcho and FD.SYS
  68.     from InterMail. After converting AREAFILE.GE to IMFOLDER.CFG it will
  69.     update FD.SYS with the origin lines and missing AKA's.
  70.     Also JAM areas will be added to IMFOLDER.CFG, though they can not yet
  71.     be read with the InterEditor.
  72.  
  73.     Switches : 
  74.       - Description: GE2IM will use the descriptions instead of the
  75.                      areatag name, when no description is entered in the 
  76.                      areamanager the areatag will be used. Instead of 
  77.                      entering 'Description' you can use 'D'.
  78.       - External   : Like description but now you can use an external
  79.                      desciption file. GE2RA.DES for example. GE2IM will 
  80.                      first try to find GE2IM.DES, otherwise GE2IM will try 
  81.                      to find GE2RA.DES.
  82.       - GroupSort  : Sort areas by group and name instead on areatag.
  83.       
  84. ┌────────────────────────────────────────────────────────────────────────────┐
  85. │ ▒▒▒ The Utils, Small doc's: GE2FD ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  86. └────────────────────────────────────────────────────────────────────────────┘
  87.  
  88.   ■ GE2FD convert GEcho to FrontDoor 
  89.     GE2FD doesn't need any configuration, it will look for both GEcho and
  90.     the FrontDoor environment for the nessesary configuration files.
  91.     When GE2FD is executed it will read SETUP.GE from GEcho and SETUP.FD
  92.     from FrontDoor. After converting AREAFILE.GE to FOLDER.FD it will
  93.     update SETUP.FD with the origin lines and missing AKA's. The AKA's will
  94.     only be added if there are empty places.
  95.     JAM areas will not yet be converted to FOLDER.FD, I don't now if Frontdoor
  96.     already supports JAM.
  97.  
  98.     Switches : 
  99.       - Description: GE2IM will use the descriptions instead of the
  100.                      areatag name, when no description is entered in the 
  101.                      areamanager the areatag will be used. Instead of 
  102.                      entering 'Description' you can use 'D'.
  103.       - External   : Like description but now you can use an external
  104.                      desciption file. GE2RA.DES for example. GE2IM will 
  105.                      first try to find GE2FD.DES, otherwise GE2FD will try 
  106.                      to find GE2RA.DES.
  107.       - GroupSort  : Sort areas by group and name instead on areatag.
  108.  
  109. ┌────────────────────────────────────────────────────────────────────────────┐
  110. │ ▒▒▒ The Utils, Small doc's: GE-NOT ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  111. └────────────────────────────────────────────────────────────────────────────┘
  112.  
  113.   ■ GE-NOT, GEcho node notify.
  114.     GE-NOT can be used if you want to write a notify message to just one
  115.     node regardles the notify settings in the node manager.
  116.  
  117.     Switches: 
  118.       - Address, address to whom a notify should be written.
  119.         If GE-NOT can not find the address in the nodemanager then
  120.         no notify will be written.
  121.       - UNLINKED, send also a list with areas that still can be 
  122.         connected.
  123.       - LIST, send only notify messages to nodes whom have the notify
  124.         option set in GSetup nodemanager.
  125.  
  126.     GE-NOT can also be user with wildcard options, e.g. GE-NOT * will
  127.     write a notify to al your down/uplinks, and GE-NOT 111 will write a
  128.     notify to all nodes of zone 111.
  129.  
  130.     The Notify will have the same message status as configured in GEcho
  131.     nodemanager, for GEcho v1.00 the mail archive status will be used.
  132.     
  133. ┌────────────────────────────────────────────────────────────────────────────┐
  134. │ ▒▒▒ The Utils, Small doc's: GE2RA ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  135. └────────────────────────────────────────────────────────────────────────────┘
  136.  
  137.   ■ GE2RA convert GEcho to Remote Access
  138.     GEcho2RA needs some configuration, look into the Control file GE2RA.CTL
  139.     for an example configuration. Just like al the other programs you can 
  140.     also use the following commandline switches:
  141.  
  142.     During the update GE2RA will also update the HMB netmail boards which
  143.     can be used for netmail reply's, these areas numbers have to be entered in
  144.     both Gsetup.System Data.network addresses and the Area manager (don't 
  145.     forget to set area type to netmail).
  146.  
  147.     One small remark, Remote Access 1.11 users need also to set the RA 2.0x
  148.     options, otherwise GE2RA will exit with a error message.
  149.     
  150.     Switches : 
  151.       - Description: GE2IM will use the descriptions instead of the
  152.                      areatag name, when no description is entered in the 
  153.                      areamanager the areatag will be used. Instead of 
  154.                      entering 'Description' you can use 'D'.
  155.       - External   : Like description but now you can use an external
  156.                      desciption file called GE2RA.DES.
  157.  
  158.     GE2RA control file:
  159.     ─────────────────────────────────────────────────────────────────────────
  160.     Group {GEcho group} {Sysop Security} {User read security} {User Write
  161.           Security} {Ra message group} {Alt1 group} {Alt2 group} {Alt3 group}
  162.           {All groups} {Starting JAM area number} {Internet Email Area}
  163.  
  164.  
  165.      With the group setting you can set almost all Remote Access options for
  166.      all groups read from GEcho.
  167.      Always set Group '-', this is the default group when no GEcho group
  168.      is specified in the control file.
  169.  
  170.      - GEcho group        : GEcho's group letter (A..Z)
  171.      - Sysop security     : Sysop security for this group. (0 .. 65535)
  172.      - User read security : Security level to read this group (0 .. 65535)
  173.      - User write security: Security level to write in this group (0 .. 65535)
  174.      - RA message group   : Group number in Remote Access (0 .. 255)
  175.      - Alt1 Group         : Areas should also be available in this group
  176.                             (0..65535)
  177.      - Alt2 Group         : Areas should also be available in this group
  178.                             (0..65535)
  179.      - Alt3 Group         : Areas should also be available in this group
  180.                             (0..65535)
  181.      - All groups         : Area should be available in All message groups
  182.                             (Yes / No)
  183.      - Start JAM area nbr : Area numbers should start with this areanumber
  184.                             (200 - 32000)
  185.      - Internet Email Area: Used for internet newsarea. If this parameter is 
  186.                             not equal to 0 then Areatype will be set to 
  187.                             Newsgroup 0 is normal area, (1 - 200 Internet 
  188.                             Email board}
  189.  
  190.     ─────────────────────────────────────────────────────────────────────────
  191.     Flags {GEcho group} {User Read A - D Flags} {Userwrite A - D flags}
  192.  
  193.      With Flags you can set al READ/WRITE flags for the different groups,
  194.      Always specify 'Group' if you use the Flags option, otherwise it will
  195.      be ignored!!! 
  196.      For the flags the same conventions are used as in Remote access, e.g.:
  197.      X : Flag must be SET to access this area
  198.      - : Flag doesn't matter can be ON or OFF ( 'X' or '-')
  199.      O : Flag may NOT be SET to access this area
  200.  
  201.      - GEcho group        : GEcho group ( A .. Z )
  202.      - UserRead A         : User Read flags ( A - Flags )
  203.      - UserRead B         : User Read flags ( B - Flags )
  204.      - UserRead C         : User Read flags ( C - Flags )
  205.      - UserRead D         : User Read flags ( D - Flags )
  206.      - UserWrite A        : User Write flags ( A - Flags )
  207.      - UserWrite B        : User Write flags ( B - Flags )
  208.      - UserWrite C        : User Write flags ( C - Flags )
  209.      - UserWrite D        : User Write flags ( D - Flags )
  210.  
  211.     ─────────────────────────────────────────────────────────────────────────
  212.     SysopFlags {A - D Flags}
  213.  
  214.     This option sets al sysop flags to the flags specified in the controle
  215.     file. For Settings see Flags statement Above.
  216.  
  217.     ─────────────────────────────────────────────────────────────────────────     
  218.     Stripfirst {Description}
  219.  
  220.     Will be used when you use GEcho internal comments (descriptions) as
  221.     area tags' in RA, with this option you can strip 1 word from a description.
  222.  
  223.     - Description, part of description to strip for internal desciptions.
  224.       (do not use spaces, everything after a space will be ignored.)  
  225.  
  226.   
  227.     ─────────────────────────────────────────────────────────────────────────     
  228.     Areatag {Tagname}{DefaultGrp}{Alt1}{Alt2}{Alt3}{All}{Users}{Attribute}
  229.             {Read}{Write}
  230.  
  231.     With Areatag you have the possibility to set some options for some 
  232.     specific areas.
  233.  
  234.     - Tagname      : GEcho areatag name
  235.     - Defaultgroup : The default Remote Access group
  236.     - Alt 1 group  : Include this area also in this group, alternative group.
  237.                      0 to ignore.
  238.     - Alt 2 group  : Include this area also in this group, alternative group
  239.                      0 to ignore.
  240.     - Alt 3 group  : Include this area also in this group, alternative group
  241.                      0 to ignore.
  242.     - All          : Include this area in all groups.
  243.     - Users        : Username allowence: REAL   = Real names only
  244.                                          HANDLE = Handles only
  245.                                          PICK   = Pick an alias
  246.     - Attribute    : Set area specific information:
  247.                       Attributes:   12345678
  248.                                     ||||||| \- Internet Email board (RA 2.02)
  249.                                     |||||| \-- Public
  250.                                     ||||| \--- Private
  251.                                     |||| \---- Echoinfo
  252.                                     ||| \----- Combined
  253.                                     || \------ Attaches
  254.                                     | \------- SoftCr's
  255.                                      \-------- Allow Delete
  256.     - Read         : Set area read security
  257.     - Write        : Set area write security
  258.  
  259.  
  260.     ─────────────────────────────────────────────────────────────────────────     
  261.     Excludegroups {Groups}
  262.  
  263.     With this option you can instruct GE2RA to ignore specific groups from 
  264.     GEcho to export to Remote Access. This option will overrule all previous
  265.     settings.
  266.     
  267.     - Groups  : GEcho groups to ignore, without spaces!!
  268.  
  269.     ─────────────────────────────────────────────────────────────────────────     
  270.     Messagepath {path}
  271.  
  272.     With the this parameter you can set the path to your MESSAGES.RA
  273.     if not used then the systempath will be used.
  274.  
  275.     ─────────────────────────────────────────────────────────────────────────     
  276.     SystemPath {Path}
  277.  
  278.     If GE2RA can't find your CONFIG.RA or if you want to use a specific config 
  279.     file then you can use this option.
  280.  
  281. ┌────────────────────────────────────────────────────────────────────────────┐
  282. │ ▒▒▒ System Hardware and Software Requirements ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  283. └────────────────────────────────────────────────────────────────────────────┘
  284.  
  285.  
  286.    ■  IBM PC, AT or 100% compatible, with hard drive.
  287.  
  288.    ■  Microsoft MS-DOS or IBM PC-DOS 3.0 or higher.
  289.  
  290.    ■  GEcho v1.00 or higher - Echo-Mail-Processor by Gerard Van Der Land.
  291.  
  292.    ■  InterMail from v2.27 or FrontDoor v2.02/NC
  293.  
  294.    ■  Remote Access v1.11 - 2.02
  295.  
  296.  
  297. ┌────────────────────────────────────────────────────────────────────────────┐
  298. │ ▒▒▒ Disclaimer ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  299. └────────────────────────────────────────────────────────────────────────────┘
  300.  
  301.    ■ The badecho-package is a "freeware program" and is provided at no
  302.      charge to the user. Feel free to share it with your friends, but 
  303.      please do not give it away altered or as part of another system. 
  304.  
  305.    ■ In no way Wieger Vellema can be held responsible for any damage 
  306.      done to your system by using the GCU package.
  307.  
  308.    ■ Although care has been taken to write and test a program that
  309.      does what this document states, GCU is provided as is,
  310.      without warranty or garantee of any kind, either expressed or
  311.      implied, as to the fitness for a particular purpose or quality
  312.      or performance of this program, except that GCU will occupy
  313.      disk space.
  314.  
  315.    ■ Wieger Vellema doesn't give you the garantee that he will continue 
  316.      developing or support GCU for any future versions.
  317.  
  318.    ■ Your use of GCU constitutes your agreement to this license
  319.      and disclaimer and your release of the author from any form of
  320.      liability or litigation.
  321.  
  322.    ■ GCU may NEVER be used in a commercial environment without written
  323.      notice from the author.
  324.  
  325.  
  326. ┌────────────────────────────────────────────────────────────────────────────┐
  327. │ ▒▒▒ Registration ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  328. └────────────────────────────────────────────────────────────────────────────┘
  329.  
  330.  
  331.   GCU is at this moment freeware, but it will become shareware in the future, 
  332.   i'm not quiet sure when i make it shareware, it just depends on the time i 
  333.   spend programming with it, until now it's mostly programmed for my own 
  334.   needs and some good friends.
  335.  
  336.   If you like the GCU utilities then send me a (net)mail saying you do use
  337.   it or either hate it. This way i can see if it's usefull for me to continue
  338.   developping GCU. You also should write me if you think i should extend
  339.   the GCU package with some new options or programs.
  340.  
  341.  
  342. ┌────────────────────────────────────────────────────────────────────────────┐
  343. │ ▒▒▒ Registration Sites ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  344. └────────────────────────────────────────────────────────────────────────────┘
  345.  
  346.  
  347.   None, though if you would like to send me some money i would appreciate 
  348.   it. I Never seem to get enough of it ;-). Anyway let me know what you think
  349.   of it, either by netmail or snailmail.
  350.  
  351.   Postal Address:  Tievelco Group          
  352.                    Wieger Vellema
  353.                    P.O. Box 1557
  354.                    3500 BN  Utrecht
  355.                    Netherlands
  356.   PostgiroAccount: 6032655
  357.  
  358.  
  359. ┌────────────────────────────────────────────────────────────────────────────┐
  360. │ ▒▒▒ Credits ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  361. └────────────────────────────────────────────────────────────────────────────┘
  362.  
  363.  
  364.    ■ Gerard Van Der Land for writing GEcho (the best and fastest Echomail 
  365.      tosser i know).
  366.  
  367.    ■ Robert W. van Hoeven for allowing me to distribute GCU through the 
  368.      international D.I.S.P. file echo.
  369.  
  370.    All brand and product names are Copyrighted (C) material, Trademarks
  371.    (tm) or Registered (R) Trademarks of their respective holders:
  372.  
  373.    GEcho                       Gerard Van Der Land
  374.    Borland Pascal 7.0          Borland International, INC.
  375.    D.I.S.P.                    Robert W. van Hoeven 
  376.    InterMail                   InterZone software
  377.    FrontDoor                   Advanced Engineering sarl.
  378.    Remote Access               Wantree Development
  379.  
  380. ┌────────────────────────────────────────────────────────────────────────────┐
  381. │ ▒▒▒ Distribution Sites ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  382. └────────────────────────────────────────────────────────────────────────────┘
  383.  
  384.